Programming with QuickTime VR

QTVRGetVisibleHotSpots

You can use the QTVRGetVisibleHotSpots function to get a list of the currently visible hot spots in a QuickTime VR movie.



 
UInt32 QTVRGetVisibleHotSpots (QTVRInstance qtvr, Handle hotSpots);

qtvr: An instance of a QuickTime VR movie.
hotSpots: On entry, a handle to a block of memory. On exit, that block of memory is filled with a list of the IDs of the visible hot spots in the specified QuickTime VR movie. If necessary, the handle is resized to hold all the hot spot IDs. Accordingly, the handle must be unlocked at the time you call QTVRGetVisibleHotSpots .
function result: The number of hot spots whose IDs are returned though the hotSpots parameter.

DESCRIPTION

The QTVRGetVisibleHotSpots function returns, in the block of memory specified by the hotSpots parameter, a list of IDs of all the hot spots in the QuickTime VR movie specified by the qtvr parameter that are currently visible. QTVRGetVisibleHotSpots also returns, as its function result, the number of hot spot IDs returned though the hotSpots parameter.

The handle specified by the hotSpots parameter must be a valid handle created by the Memory Manager.